home *** CD-ROM | disk | FTP | other *** search
/ PC Users 1998 March / Pc Users extra 6.iso / nostalgi / hc / amiga / docs / qsetup.dos < prev    next >
Encoding:
Text File  |  1995-07-25  |  10.4 KB  |  251 lines
  1. ******************************************************************************
  2. *                UAE - THE UN*X AMIGA EMULATOR Version 0.6.9                 *
  3. *                           Written by Bernd Scmidt                          *
  4. *                                                                            *
  5. *                       Q U I C K  S E T U P  G U I D E                      *              *
  6. *                       ---------  ---------  ---------                      *              *
  7. ******************************************************************************
  8.  
  9. Update for 0.6.9 version by Gustavo Goedert.
  10.  
  11. [FOREWORD]
  12.  
  13. This document has been produced to help the beginner install, configure and
  14. run UAE quickly and easily.  Some people have experienced difficulties in
  15. getting UAE set up properly so I have decided to put together this guide to
  16. help those folks out.
  17.  
  18.                                                         Brett Eden
  19.  
  20. <STEP ONE>
  21.  
  22. From a MS-DOS Shell, create a new directory somewhere on your hard-disk.
  23. This is where you'll be installing UAE, so give it a logical name like UAE
  24. or UAE069, or whatever the version number might be.  This is done using the
  25. mkdir command:
  26.  
  27. mkdir UAE <ENTER>
  28.  
  29. <STEP TWO>
  30.  
  31. Copy the .zip files containing the UAE distribution into the UAE directory.
  32. Take for example you downloaded them into a directory called DOWNLOAD, and
  33. we wanted to copy them into the UAE directory.
  34.  
  35. This is done using the copy command:
  36.  
  37. copy C:\DOWNLOAD\DUAE*.zip C:\UAE
  38.  
  39. <STEP THREE>
  40.  
  41. Unzip the DOS UAE distribution archives, using PKUNZIP or your favourite
  42. zip handling utility:
  43.  
  44. pkunzip DUAE*.zip
  45.  
  46. <STEP FOUR>
  47.  
  48. Run the batchfile 'RUNME.BAT', to finish the instalation procedure. It
  49. will prompt for 4 return keys. At dos prompt type:
  50.  
  51. runme
  52.  
  53. (it will produce an normal warning at the end)
  54.  
  55. <STEP FIVE>
  56.  
  57. You should now have a directory full of files, as well as a couple of
  58. sub-directories.
  59.  
  60. <STEP SIX>
  61.  
  62. Before we can launch UAE, we're going to need some software to run on it,
  63. aswell as a Kickstart ROM image so that we can use the Workbench operating
  64. system.
  65.  
  66. I'm going to use two examples here.  Firstly, I'm going to show you how to
  67. install UAE disk-images that you may have downloaded from the Internet
  68. or obtained from somewhere else.  Secondly, I'll demonstrate how to obtain
  69. disk-image files from a real Amiga computer.
  70.  
  71. 1. Software you've downloaded or copied from elsewhere.
  72.  
  73. We'll need to copy our new disk-images into the UAE directory, so that we
  74. don't lose them.  Let's assume we either downloaded them to C:\DOWNLOAD
  75. or have them on a 3.5" floppy disk.
  76.  
  77. In the case of having downloaded them:
  78.  
  79. copy C:\DOWNLOAD\GAME.ADF C:\UAE
  80.  
  81. And in the case of our 3.5" floppy disk:
  82.  
  83. copy A:\GAME.ADF C:\UAE
  84.  
  85. You may find that your 3.5" disk drive is B: and not A:, in which case
  86. you'll have to make the appropriate changes to the above command.
  87. GAME.ADF is just an example file name, and you may find that the image
  88. you have obtained may be called something else, in which case you'll have
  89. to make that change in either of the above commands.
  90.  
  91.  
  92. 2. Obtaining disk-images from a real Amiga.
  93.  
  94. In your UAE directory, you will find a subdirectory called AMIGA.  In here
  95. are four utilities: transdis, transrom, uaectrl and uae-cont.  Right now,
  96. we'll only look at two of them, transdis and transrom.
  97.  
  98. Transdis (Actually called Transdisk, but was shortened to meet DOS's 8 letter
  99. file name requirements) and transrom need to be copied over to the real
  100. Amiga so that we can obtain the necessary software to use with UAE.
  101.  
  102. I'm going to make example of two ways which you can copy these files to an
  103. Amiga.
  104.  
  105. a) Floppy disk.
  106.  
  107. Amiga's equipped with CrossDOS software (bundled with versions 2.1 and
  108. later of Workbench) can read 720KB IBM PC disks.  By formatting a 720KB disk
  109. on your PC and copying the transdisk and transrom files to it, you can them
  110. take it over to the Amiga and copy it there, where it can be used.
  111.  
  112. b) Null-modem cable.
  113.  
  114. If you happen to own a null-modem cable, or can borrow one for use, you can
  115. use it to copy files between an Amiga and a PC with the aid of a terminal
  116. package like Telix, Terminate, Telemate or any similar packages like the
  117. ones that are bundled with Windows 3.x and Windows 95.  Initiating a X, Y or
  118. Z modem transfer between the two machines after the cable has been attached
  119. and the terminal packages loaded should enable you the copy the files to
  120. the Amiga.
  121.  
  122. Now that we have our transdisk and transrom files on the Amiga, we can start
  123. making some disk images to use with UAE, aswell as that Kickstart ROM image
  124. we're going to need.  If you're only planning on running games on UAE, you
  125. won't need a Kickstart ROM image unless the games in question has some
  126. components from the Workbench operating system included with it.
  127.  
  128. Open a shell and type the following:
  129.  
  130. transrom >DH0:
  131.  
  132. Will generate the file "kick.rom" on the DH0: harddisk.  Obtaining files
  133. from an Amiga without a hard-disk is next to impossible, so I'm not going
  134. to go into it here.  If you don't have a hard-disk on your Amiga, find
  135. someone who does or obtain your disk images elsewhere.
  136.  
  137. To make a disk image of your favourite game, insert the disk into the DF0:
  138. floppy drive and type the following from a shell:
  139.  
  140. transdisk >DH0:GAME.ADF
  141.  
  142. Will create the file GAME.ADF on DH0:, which is actually a copy of the disk
  143. in DF0: which UAE can use.
  144.  
  145. A full description of the transdisk and transrom commands are in the main
  146. documentation, so consult there if you want to know more about how they work.
  147.  
  148. <STEP SEVEN>
  149.  
  150. Now that we've created our Kickstart ROM image and our disk image(s), we'll
  151. have to get them over to the PC for UAE to use them.  As I mentioned above,
  152. you can copy files over a null-modem cable using a terminal package.  If
  153. this doesn't sound like the way for you, you can use LhA or ZIP to compress
  154. the images on the Amiga and then copy them to a 720KB disk (using CrossDOS
  155. as mentioned above) where they can be taken back to the PC, and uncompressed
  156. into the UAE directory.  I chose LhA and ZIP because they are two archiving
  157. formats supported on both the Amiga and tha PC.
  158.  
  159. <STEP EIGHT>
  160.  
  161. All being well, you should now have a Kickstart ROM image and one or more
  162. disk images in your UAE directory.  The Kickstart ROM, providing it is named
  163. "kick.rom" will be automatically detected by UAE, so we won't have to do
  164. anything there.
  165.  
  166. We have to inform UAE that we have one or more disk images that we wish to
  167. use.  This is done by selecting "Disk Settings" from the UAE configuration
  168. menu, and DF0: to insert a disk into that drive.  After selecting DF0:,
  169. you will be presented with a file lister, from which you will have to pick
  170. the disk image file that you want to go into DF0:
  171.  
  172. DF0: is the Amiga's boot drive, so if you've transferred a multi-disk game,
  173. you'll want to put the first disk there.  If you have extra disks, allocate
  174. them to subsequent drives, DF1:, DF2:, etc.
  175.  
  176. Read over the main documentation for information on changing disk images
  177. while the emulator is running, in the case of software that has more than
  178. 4 disks.
  179.  
  180. <STEP NINE>
  181.  
  182. Now it's time to configure our sound and display settings. If you want sound
  183. while running UAE, make sure your sound card is installed and configured
  184. properly - UAE should detect it when you start up.  Select "Sound Settings"
  185. from the configuration menu and select the "Produce sound" sub-option until
  186. "on - emulated perfectly" appears over in the sound section on the right
  187. side of the screen.
  188.  
  189. How you configure your video settings depends on what kind of machine you
  190. have, and whether or not you're planning on running Workbench during a
  191. particular session.  If you have a low-end pentium system and just plan to
  192. play games, 320x200, 320x240 or 320x400 are fine.  However, if you're going
  193. to run Workbench, you will need to use 640x480 or 800x600 with aspect
  194. correction enabled if you want it to appear correct and proportional.
  195.  
  196. Slower machines should use the lower resolutions, with 256 colours.  Faster
  197. machines running Workbench should use the SVGA modes with either 256 or more
  198. colours.
  199.  
  200. If you find that a game runs too slow on your machine, edit the frame option
  201. in the "Video Settings" menu.  This will make the emulator skip a set number
  202. of frames to speed up the display.
  203.  
  204. <STEP TEN>
  205.  
  206. If you don't have a joystick, you can map the joystick controls to the keypad
  207. on your keyboard, so you can still control games as you would normally with
  208. a joystick. This can be set under the "Other Settings" menu.  Alternatively,
  209. you can use a real Joystick, which UAE should detect when you first run it.
  210.  
  211. <STEP ELEVEN>
  212.  
  213. All things being well and good, you should now be ready to run UAE. Consult
  214. the following check list to make sure you've got everything configured
  215. correctly.
  216.  
  217. ■ Have you launched your mouse driver program before running UAE?  Workbench
  218.   and a lot of games will not function without a mouse.
  219.  
  220. ■ Do you have a disk image assigned to (at the very least) DF0:?
  221.  
  222. ■ If you're going to run Workbench, do you have a Kickstart ROM image
  223.   installed in the UAE directory?  Is it named "kick.rom"?
  224.  
  225. ■ If planning on running UAE in SVGA modes, does your video hardware support
  226.   Vesa BIOS extensions?  If not, the display will not look correct.  Consult
  227.   the main documentation for more information on this, and where to obtain
  228.   a VBE driver.
  229.  
  230. After you're certain you have everything set up properly, launch UAE by
  231. selecting the "Run UAE!" option from the top of the UAE configuration menu.
  232. If, for some reason, it does not work as expected, consult the main
  233. documentation for troubleshooting tips.
  234.  
  235. If you're still having problems after you've read this document, there are
  236. still several avenues where you can find help in getting UAE running.  They
  237. are as follows:
  238.  
  239. ■ The author of the DOS port of UAE has set up a UAE discussion board on
  240.   the World Wide Web, where you can ask general questions about UAE.  You're
  241.   certain to get the answer you want here, because of the number of people
  242.   who participate in the service.
  243.  
  244. ■ If you have access to IRC, you can try the #amiga or #amigauae channel, as
  245.   there are normally people there who have experience with UAE and can help
  246.   you.
  247.  
  248. ■ The author of this document <beden@eastwind.com.au> has offered his
  249.   services in answering general UAE queries.  Answers are normally given the
  250.   following day.
  251.